home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / tbox3_21.zip / install.exe / AppStart / AppStart.txt < prev    next >
Text File  |  1997-07-16  |  3KB  |  87 lines
  1.                                   AppStart.tbx
  2.                                   ------------
  3. 0) Installation
  4.    Running init.cmd will be sufficient in most cases.
  5.     However you may want to add extra items (and/or menus) to the TaskBox, see
  6. section 3 for details.
  7.  
  8. 1) Usage
  9.    the left mouse button works like on a normal menu.
  10.    a right mouse button click on the object always open the object.
  11.    ( if mouse is configure for a left hand user swap left & right over in the
  12.       above )
  13.  
  14. 2) Customising icons
  15.     The "icon.dat" contained in the TaskBox directory can be used for customising
  16. icons. The general format of the ICON command is.
  17.  
  18.    ICON "path/object" "icon"
  19.  
  20.    Where "path/object" is one of two things
  21.        i) the fully qualified file name of the object/folder eg "E:\\Desktop"
  22.        ii) the object id eg "<WP_DESKTOP>"
  23.    ( NB: remember to use double backslashes to separate paths components. )
  24.  
  25.    and "icon" takes one of the following formats
  26.         i) fully qualified pathname eg "E:\\os2\\apps\\epm.exe" or
  27.                 "E:\\icons\\file.ico"
  28.         ii) filename (AppStart will search along the PATH for the file/icon) eg
  29.                 "epm.exe" "file.ico"
  30.         iii) resource dll, icon id eg ''TaskBox, 1000"
  31.  
  32. 3) Startup.dat ( located in the TaskBox directory)
  33.     This file is used for adding items to the TaskBox. The general format of the
  34. commands used is
  35.  
  36.     START "path/object" "menu.dat" "icon"
  37.  
  38.     Where "path/object" and "icon" are as defined in section 2) and "menu.dat" is
  39. the location of menu.dat file to use.
  40.  
  41. ( NB: "menu.dat" and/or "icon" may be ommited
  42.       if an "icon" is wanted and no "menu.dat" file is wanted use "" in place of
  43.             "menu.dat" eg.  START "<WP_MOUSE>" "" "mouse.ico"   )
  44.  
  45. 4)  menu.dat
  46.    The "menu.dat" file is searched for in any sub-folders and if one is not
  47. found the "menu.dat" in the next top folder will be tried until the "menu.dat"
  48. file  specified by the START command is reached.
  49.    All "menu.dat" files except that specified by the START command must be
  50. called  "menu.dat"
  51.  
  52.    The "menu.dat" file understands various commands
  53.    i) to use mini-icon specify
  54.           MINI = YES
  55.    ii) to have extentions removed automatically from files specify
  56.             REMOVE_EXT = NO
  57.    iii) to decide justification of text use
  58.             TEXT       = "just"
  59.         where just is one of RIGHT, CENTER or LEFT
  60.  
  61.    iv)  to add additional abstract items( or given an item in a folder an
  62.         alternate name)
  63.  
  64.        ABSTRACT "path/object" "title" "icon"
  65.      where
  66.        "path/object" and "icon" as is  section 2)
  67.        "title" is optional and if supplied is the text to use on the menu
  68.  
  69.       special "path/object" identifies for ABSTRACT are
  70.          SEPARATOR   -  insert a menu separator
  71.          SHUTDOWN    -  shutdown computer
  72.          LOCKUP      -  lockup computer
  73.  
  74.    NB: menu.dat also understands ICON "path/object" "icon" but it is probably
  75.         better to keep all of these in the "icon.dat" file
  76.  
  77. This module is still in a very experimental stage however it shouldn't damage
  78. anything.
  79.  
  80. Legal Stuff
  81. -----------
  82. AppStart.tbx is (c) Copyright 1996 by Kevin Ash.
  83.  
  84. Appstart.tbx is distributed in the hope that it will be useful, but with
  85. ABSOLUTELY NO WARRANTY; without even the implied warranty of MERCHANTABILITY
  86. or FITNESS FOR A PARTICULAR PURPOSE.
  87.